Capítulo 7 · Do Endereço ao Mapa — Geocodificação com Geopy

pip install geopy

# 1. Importar a classe do provedor escolhido
from geopy.geocoders import ArcGIS

# 2. Criar o geocodificador (nosso "controle remoto")
geolocator = ArcGIS()

# 3. Enviar o endereço para a API
endereco = "IFSC Florianópolis, Avenida Mauro Ramos, 950, Centro, Florianópolis, SC"
print(f"Buscando as coordenadas para: '{endereco}'")

try:
    location = geolocator.geocode(endereco, timeout=10)

    # 4. Conferir se o resultado é válido
    if location:
        print(f"\nEndereço completo encontrado: {location.address}")
        print(f"Latitude: {location.latitude}")
        print(f"Longitude: {location.longitude}")
        print(f"Coordenadas: ({location.latitude}, {location.longitude})")
        # print(f"Dados brutos: {location.raw}")
    else:
        print("\nEndereço não encontrado ou ambíguo. Tente detalhar mais.")

except Exception as e:
    print(f"\nOcorreu um erro durante a geocodificação: {e}")

import pandas as pd
from pathlib import Path

fonte = Path('arquivos/NEIM.txt')
destino = Path('enderecos.txt')

df = pd.read_csv(fonte, sep=';', encoding='utf-8')

df[['Nome', 'Endereço']].to_csv(destino, sep=';', index=False, header=False)

print(f"Arquivo '{destino}' criado com {len(df)} endereços.")

NEIM Abraão;Rua João Meirelles, n° 1780 - Abraão, Florianópolis
NEIM Anjo da Guarda;Rua João da Cruz Meira, n° 350 - Trindade, Florianópolis
NEIM Campeche;Servidão Dionísio Rafhael Ignácio, n° 287 - Campeche, Florianópolis
NEIM Coqueiros;Rua Bento Góia, n° 185 - Coqueiros, Florianópolis
NEIM Ingleses I;Rua Três Maria, n° 1040 - Ingleses, Florianópolis
Lugar Inválido;Rua Inexistente, 9999, Bairro Fantasma, Cidade Nenhuma

import pandas as pd
from geopy.geocoders import ArcGIS
import time

# --- 1. Configuração ---
geolocator = ArcGIS()
arquivo_entrada = 'enderecos.txt'
arquivo_saida = 'escolas_geocodificadas.csv'
resultados_geocodificados = []

print(f"Iniciando a geocodificação do arquivo '{arquivo_entrada}'...")

try:
    with open(arquivo_entrada, 'r', encoding='utf-8') as f:
        for linha in f:
            if not linha.strip():
                continue

            partes = linha.strip().split(';')
            if len(partes) != 2:
                print(f"  - AVISO: Linha mal formatada, pulando: '{linha.strip()}'")
                continue

            nome_escola, endereco_para_buscar = partes
            print(f"  - Geocodificando: {nome_escola}...")

            try:
                location = geolocator.geocode(endereco_para_buscar, timeout=10)

                if location:
                    resultados_geocodificados.append({
                        'nome_escola': nome_escola,
                        'endereco_encontrado': location.address,
                        'latitude': location.latitude,
                        'longitude': location.longitude
                    })
                else:
                    print(f"    AVISO: Endereço para '{nome_escola}' não encontrado.")
                    resultados_geocodificados.append({
                        'nome_escola': nome_escola,
                        'endereco_encontrado': 'NÃO ENCONTRADO',
                        'latitude': None,
                        'longitude': None
                    })

            except Exception as e:
                print(f"    ERRO ao geocodificar '{nome_escola}': {e}")

            time.sleep(1)  # Respeito ao rate limit

except FileNotFoundError:
    print(f"ERRO CRÍTICO: O arquivo '{arquivo_entrada}' não foi encontrado.")
except Exception as e:
    print(f"Ocorreu um erro inesperado: {e}")

if resultados_geocodificados:
    df_resultados = pd.DataFrame(resultados_geocodificados)
    df_resultados.to_csv(arquivo_saida, index=False, encoding='utf-8-sig')
    print(f"\nGeocodificação concluída! Resultados salvos em '{arquivo_saida}'.")
else:
    print("\nNenhum endereço foi processado.")